package cn.iocoder.yudao.module.cms.benefit.service;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.validation.groups.UpdateGroup;
import cn.iocoder.yudao.module.cms.benefit.bo.BenefitCategoryBO;
import cn.iocoder.yudao.module.cms.benefit.dal.dataobject.BenefitDO;
import cn.iocoder.yudao.module.cms.benefit.vo.BenefitPageReqVO;
import cn.iocoder.yudao.module.cms.benefit.vo.BenefitSaveReqVO;
import jakarta.annotation.Nonnull;
import jakarta.validation.Valid;
import org.springframework.validation.annotation.Validated;

import java.util.List;

/**
 * 权益保障 Service 实现类
 *
 * @author 山野羡民
 */
public interface BenefitService {

    /**
     * 创建权益保障
     *
     * @param reqVO 创建信息
     * @return 编号
     */
    Long createBenefit(@Valid BenefitSaveReqVO reqVO);

    /**
     * 更新权益保障
     *
     * @param reqVO 更新信息
     */
    void updateBenefit(@Validated(value = UpdateGroup.class) BenefitSaveReqVO reqVO);

    /**
     * 删除权益保障
     *
     * @param id 编号
     */
    void deleteBenefit(Long id);

    /**
     * 获得权益保障
     *
     * @param id 编号
     * @return 权益保障
     */
    BenefitDO getBenefit(Long id);

    /**
     * 获得权益保障分页
     *
     * @param pageReqVO 分页查询
     * @return 权益保障分页
     */
    PageResult<BenefitDO> getBenefitPage(BenefitPageReqVO pageReqVO);

    /**
     * 获得权益保障种类列表
     *
     * @return 权益保障种类列表
     */
    List<BenefitCategoryBO> getAllCategory();

    /**
     * 获得权益保障列表
     *
     * @param category 种类
     * @return 权益保障列表
     */
    @Nonnull
    List<BenefitDO> getBenefitList(String category);

}
